home *** CD-ROM | disk | FTP | other *** search
/ MACD 5 / MACD 5.bin / workbench / tools / czesc_3 / pubscreens / pubscreen.doc < prev    next >
Text File  |  1990-12-17  |  5KB  |  119 lines
  1. ==============================================================================
  2.  
  3.         Public Screen Manager           V1.0
  4.         © J.Tyberghein                  Mon Sep 24 11:13:12 1990
  5.  
  6. ==============================================================================
  7.  
  8.  
  9.  
  10. Preface
  11. -------
  12.   I made this utility when I discovered a new feature in AmigaDOS 2.0:
  13.   Public Screens. This utility manages public screens. You can open,
  14.   close, list, ... public screens in any form you wish.
  15.   Normally the 'Workbench' public screen is the default one, but with
  16.   this utility you can make another public screen and make it default.
  17.   All programs you execute will get their window on this new screen instead
  18.   of on the workbench screen.
  19.  
  20.   This program (PUBSCREEN V1.0) is public domain but contributions and some
  21.   utilities are always welcome.
  22.   If you want to use this program for commercial purposes please write
  23.   for permission !
  24.  
  25.   If you have any suggestions or remarks you can write to (Bug reports are
  26.   welcome too)
  27.  
  28.                             Jorrit  Tyberghein
  29.                              Hepmansbossen 31
  30.                            2450 Meerhout BELGIUM
  31.  
  32.  
  33. WARNING
  34. -------
  35.   If you want to use this utility you must have AmigaDOS 2.0 (or later :-).
  36.   This utility is pure so you can use it with ARes, Resident, ...
  37.   PUBSCREEN is a cli program.
  38.   Messing with public screens is completely your responsibility. You could
  39.   crash the Amiga if you do dirty things (like closing screens that do not
  40.   belong to you).
  41.  
  42.  
  43. Syntax
  44. ------
  45.  
  46.  
  47.   +--------------------------------------------------------------------------+
  48.   | Commandline template:                                                    |
  49.   |   Name,O=OPEN/s,C=CLOSE/s,D=DEFAULT/s,SN=SCRNAME/k,I=INFO/s,L=LIST/s,    |
  50.   |   DIM/k,SH=SHANGHAI/n,NOFREE/s,LORES/s,HAM/s,EHB/s,DPF/s,DPF2/s,         |
  51.   |   SUPER/s,LACE/s,VGA/s,A2024/s:                                          |
  52.   |--------------------------------------------------------------------------|
  53.   | Usage:                                                                   |
  54.   |   PubScreen [<Name>] [Open] [Close] [Default] [ScrName <name>] [Info]    |
  55.   |             [List] [DIM [<left>],[<top>],[<width>],[<height>],[<depth>]] |
  56.   |             [SHanghai <switch>] [NOFREE] [LORES] [HAM] [EHB] [DPF] [DPF2]|
  57.   |             [SUPER] [LACE] [VGA] [A2024]                                 |
  58.   +--------------------------------------------------------------------------+
  59.  
  60.     Name    : public screen name (only for 'Open','Close','Default', 'Info' and
  61.               'DIM' options, <Name> is ignored for all other options).
  62.     Open    : open the public screen <Name>
  63.     Close   : close the screen <Name>
  64.     Default : make <Name> the default public screen
  65.     Info    : give information about <Name>
  66.     List    : list all public screens
  67.     DIM     : specify screen dimensions (only for 'Open' option, ignored for other
  68.               options).
  69.     SHanghai: set shanghai mode on (1) or off (0). When shanghai mode is on, all
  70.               windows with type WBENCH_WINDOW appear on the default public screen.
  71.               When this mode is off, they always appear on the workbench screen
  72.               and not on the default public screen.
  73.     ScrName : screen name (only for 'Open' option).
  74.     NOFREE  : do not free screen name (for 'Close')
  75.               You must use this option if you try to close a public screen that
  76.               was not opened with PUBSCREEN. You should not use this option if
  77.               the screen was opened with PUBSCREEN.
  78.               PUBSCREEN and PUBLICS are compatible. Do not use this option when
  79.               you want to close a PUBLICS screen.
  80.     (The following options are for 'Open' only.
  81.     LORES   : open a lores screen.
  82.     HAM     : open a ham screen.
  83.     EHB     : extrahalfbrite.
  84.     DPF     : dualplayfield.
  85.     DPF2    : dualplayfield (other priorities).
  86.     SUPER   : a superhires screen (ECS).
  87.     LACE    : an interlace screen.
  88.     VGA     : for vga monitors.
  89.     A2024   : for A2024 monitors.
  90.  
  91.  
  92. examples
  93. --------
  94.  
  95.   Open a normal interlaced screen with 2 bitplanes and default size.
  96.  
  97.     PUBSCREEN MyScreen open dim ,,,,2 lace
  98.       or
  99.     PUBSCREEN MyScreen o dim ,,,,2 lace
  100.  
  101.   Open a big HAM screen and make this public screen the default one.
  102.  
  103.     PUBSCREEN MyHAMScreen open dim 0,0,1000,500,6 ham default shanghai 1
  104.       or
  105.     PUBSCREEN MyHAMScreen o dim 0,0,1000,500,6 ham d sh 1
  106.  
  107.   List all public screens.
  108.  
  109.     PUBSCREEN list
  110.       or
  111.     PUBSCREEN l
  112.  
  113.  
  114. ==============================================================================
  115.  
  116.                        End of PUBSCREEN 1.0 document
  117.  
  118. ==============================================================================
  119.